package com.bdqn.mapper;

import com.bdqn.pojo.SysUser;
import org.apache.ibatis.annotations.Param;

import java.util.List;
import java.util.Map;

/**
 * SysUserMapper
 *
 * @author LILIBO
 * @since 2024/12/6
 */
public interface SysUserMapper {

    /**
     * 添加用户
     *
     * @param sysUser
     * @return
     */
    int add(SysUser sysUser);

    /**
     * 修改用户
     *
     * @param sysUser
     * @return
     */
    int upd(SysUser sysUser);

    /**
     * 修改用户（使用Trim）
     *
     * @param sysUser
     * @return
     */
    int updUseTrim(SysUser sysUser);

    /**
     * 删除用户
     *
     * @param id
     * @return
     */
    int del(int id);

    /**
     * 查询用户数量
     *
     * @return
     */
    int count();

    /**
     * 根据ID查询用户
     *
     * @param id
     * @return
     */
    SysUser findById(int id);

    /**
     * 查询所有用户
     *
     * @return
     */
    List<SysUser> findAll();

    /**
     * 根据真实姓名查询用户
     *
     * @param realName
     * @return
     */
    List<SysUser> findByRealName(String realName);

    /**
     * 查询任意表
     *
     * @return
     */
    List<SysUser> findAny(String tableName);

    /**
     * 根据真实姓名和角色ID查询用户（使用Map传参数）
     *
     * @param paramMap
     * @return
     */
    List<SysUser> findByRealNameAndRoleIdUseMap(Map<String, Object> paramMap);

    /**
     * 根据真实姓名和角色ID查询用户（使用对象传参数）
     *
     * @param sysUser
     * @return
     */
    List<SysUser> findByRealNameAndRoleIdUsePojo(SysUser sysUser);

    /**
     * 根据真实姓名和角色ID查询用户
     *
     * @param realName
     * @param roleId
     * @return
     */
    List<SysUser> findByRealNameAndRoleId(@Param("real_name") String realName, @Param("role_id") Integer roleId);

    /**
     * 根据真实姓名和角色ID查询用户（使用Trim处理）
     *
     * @param realName
     * @param roleId
     * @return
     */
    List<SysUser> findByRealNameAndRoleIdUseTrim(@Param("real_name") String realName, @Param("role_id") Integer roleId);

    /**
     * 查询用户列表，包括角色名称
     *
     * @Param SysUser
     */
    List<SysUser> getWithRoleName(SysUser sysUser);

    /**
     * 根据角色id查询用户，包含系统角色实例
     *
     * @Param Integer
     */
    List<SysUser> getWithRoleByRoleId(Integer roleId);

    /**
     * 根据用户id查询用户，包含用户地址列表
     *
     * @Param Integer
     */
    SysUser getWithAddressByUserId(Integer userId);

    /**
     * 根据用户名称查询用户，包含用户地址列表
     *
     * @Param Integer
     */
    List<SysUser> getWithAddressByRealName(String realName);

    /**
     * 根据角色id列表查询用户（使用数组传参）
     *
     * @param roleIds
     * @return
     */
    List<SysUser> getByRoleIdArray(@Param("roleIds") Integer[] roleIds);

    /**
     * 根据角色id列表查询用户（使用列表传参）
     *
     * @param roleIds
     * @return
     */
    List<SysUser> getByRoleIdList(List<Integer> roleIds);

    /**
     * 根据真实姓名和角色ID分页查询用户
     *
     * @param realName
     * @param roleId
     * @param pageNo
     * @param pageSize
     *
     * @return
     */
    List<SysUser> getByPage(@Param("real_name") String realName, @Param("role_id") Integer roleId, @Param("pageIndex") Integer pageIndex, @Param("pageSize") Integer pageSize);

}
